home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 52 / Amiga Format AFCD52 (Issue 136, May 2000).iso / -screenplay- / shareware / warpquake / warpquake.readme < prev    next >
Text File  |  2000-02-29  |  6KB  |  192 lines
  1. Short: WarpOS Quake port
  2. Type: game/shoot
  3. Author: Jarmo Laakkonen (jami.laakkonen@kolumbus.fi)
  4. Uploader: Jarmo Laakkonen (jami.laakkonen@kolumbus.fi)
  5.  
  6. WarpQuake 0.4    26-01-2000
  7.  
  8. WarpQuake is a port of Quake based on Awinquake 0.4 by Peter McGavin.
  9.  
  10. Requirements:
  11.  
  12. PPC board with WarpOS installed.
  13. AGA or GFX board.
  14. TCP/IP stack for network games.
  15. lowlevel.library for joypad support.
  16. Optionally chunkyppc.library.
  17.  
  18. chunkyppc.library is not required, but should speed up things on GFX cards.
  19. Unfortunately I haven't been able to test WarpQuake on a GFX card system,
  20. as I only have AGA, but it should work. In case you have problems with the
  21. chunkyppc support, you can use the -wpa8 switch, but then the game might
  22. run a bit slower.
  23.  
  24. The networking code has only been tested by running two Quake executables
  25. on the same machine. This worked fine.
  26.  
  27. Amiga specific commandline options:
  28.  
  29. -bat:
  30. Change to BAT MMU setup. This should give a slight speed increase, but
  31. may cause problems on some setups.
  32. This does the same thing as the changemmu tool supplied with WarpOS.
  33.  
  34. -aga:
  35. Use native AGA support with triplebuffering instead of chunkyppc.library.
  36. This is faster than chunkyppc AGA support.
  37.  
  38. -nodb:
  39. Disables AGA multibuffering. Saves one contextswitch but causes slight
  40. flicker.
  41.  
  42. -wpa8:
  43. Use WritePixelArray8(). Use this if chunkyppc support doesn't work.
  44.  
  45. -force:
  46. chunkyppc.library saves the last used screenmode in ENV: and ENVARC:.
  47. Next time you start WarpQuake the screenmode will be read from there.
  48. Use this switch if you want to override this.
  49.  
  50. -mouse:
  51. Enables mouse. The mouse support is MUCH better than in Awinquake.
  52.  
  53. -mem:
  54. Sets the heapsize. Default is 8MB, but some Total Conversions may
  55. require more than this. BTW If you are looking for a good TC, try
  56. After the fall. You'll never want to play basic Quake again.
  57.  
  58. -joypad:
  59. Enables CD32 joypad. You need to bind the buttons yourself.
  60. The buttons are located in AUX1 - AUX11.
  61. AUX1  = left
  62. AUX2  = right
  63. AUX3  = up
  64. AUX4  = down
  65. AUX5  = red
  66. AUX6  = green
  67. AUX7  = yellow
  68. AUX8  = blue
  69. AUX9  = play
  70. AUX10 = forward
  71. AUX11 = reverse
  72.  
  73. Binding example: In Quake console type, BIND AUX5 "+ATTACK"
  74.  
  75. Additinally chunkyppc.library supports the following enviroment variables:
  76.  
  77. WarpQuake/dbuf:
  78. Use Doublebuffering.
  79.  
  80. WarpQuake/oldstyle:
  81. If this is set, ScrollVPort will be used, else Triple Buffering using
  82. ScreenBuffers.
  83.  
  84. WarpQuake/wb:
  85. If this is set, a Workbench Window will be used, not a screen
  86.  
  87. WarpQuake/pip:
  88. If this is set, a Picture in Picture will be used using the Picasso96API.library.
  89. Note: Not all Graphics Boards Support this. Currently only P96 PIP is supported,
  90. not CGX. Maybe in the future...
  91.  
  92. WarpQuake/pipnoclear:
  93. If this is set to 1, the PIP won't be cleared when opened.
  94.  
  95. WarpQuake/rtgmaster:
  96. Use rtgmaster Screenmode Requester instead of ASL one. rtgmaster.library
  97. will only be opened when this option is set, so that rtgmaster.library
  98. does not need to be installed to be able to use chunkyppc.library.
  99.  
  100. WarpQuake/likecgx:
  101. If you want CGX-like WB Window Support for P96 (Faster, but Window Borders
  102. disappear). For CGX it is automatically set, as it is the only possible
  103. method for CGX to reach (at least for 16 Bit) WB Window Support, for P96
  104. it is optional.
  105.  
  106. lockingmode:
  107. Set this to 0 for best performance on GFX cards.
  108.  
  109.  
  110. History:
  111.  
  112. 0.4:
  113. Changed -memory back to -mem ;)
  114. Removed the cd audio code as it doesn't work currently.
  115.  
  116. 0.3:
  117. Changed -mem to -memory as requested by Chris De Maeyer
  118. Small fix in the mouse handling.
  119. Some other minor changes.
  120.  
  121. 0.2:
  122. Added -bat option.
  123. ChunkyPPC double/triplebuffering actually works now ;)
  124. File access is MUCH faster now.
  125. Game hanged if no .pak files could be found.
  126.  
  127. 0.1:
  128. First release.
  129.  
  130.  
  131. Small FAQ:
  132.  
  133. Q: Why another PPC Quake port?
  134. A: Well it started when I found a bug in the -mem option of Awinquake and
  135.    decided to look at the source. After fixing that, my friend suggested
  136.    that I should learn to play with the mouse instead of the keyboard.
  137.    But the mouse support in Awinquake sucked, so I fixed that too.
  138.    Then I got fed up with the crappy PowerUP software which kept measuring
  139.    my bus speed incorrectly, so I ported it to WarpOS and added chunkyppc
  140.    and joypad support. This is also a good way to sharpen my programming
  141.    skills. Until now I have mainly done/ported some CLI programs.
  142.    I know that Frank Wille and Steffen Haeuser are working on a port too,
  143.    and when finished it will probably be much better than this. In it's
  144.    current state it's too buggy for my taste.
  145.  
  146. Q: Why does the game crash?
  147.    Maybe your stack is too low. Try setting it to 500000 bytes.
  148.    Also try without the -bat parameter.
  149.  
  150. Q: Why doesn't the game work on my GFX card?
  151. A: The GFX card support in WarpQuake might be broken, as it hasn't been
  152.    tested at all. Try the -wpa8 option.
  153.  
  154. Q: Why does mouse slow down the game so much?
  155. A: Because there's much contextswitches needed for this. If you are using
  156.    the keyboard at the same time the slowdown is even worse. This is cured
  157.    by setting the key repeat from input prefs to slowest possible. This
  158.    reduces contextswitches to minimium. If you are running on AGA and don't
  159.    mind the slight flicker, you can also try disabling multibuffering.
  160.  
  161. Q: Why doesn't the middle mouse button work?
  162. A: You probably have some commodity running that uses the button. Disable
  163.    all commodities and try again.
  164.  
  165. Q: Any other speed tips?
  166. A: Use the -bat option to change to BAT MMU setup. This gives about 1 FPS
  167.    more on my 603e/240MHz. Use 320x200 screenmode for best speed.
  168.  
  169. Q: Will there be an PowerUP version?
  170. A: No. I don't trust kernels that can't even measure the bus speed
  171.    correctly.
  172.  
  173. Q: Will there be AHI support?
  174. A: Maybe, but don't bet on it.
  175.  
  176. Q: Is the source available?
  177. A: Yes, as required by the GPL license.
  178.  
  179. Q: Why don't you get a GFX card?
  180. A: Because I'm poor.
  181.  
  182. Q: Well, why don't you get a job then?
  183. A: Because I'm lazy.
  184.  
  185. Q: You're the crapiest coder I've ever seen. Why don't you do something
  186.    useful with your life like collect stamps or something?
  187. A: I know, but I'm learning more everyday.
  188.  
  189. Q: I have some questions that are not answered in this doc. How can I
  190.    reach you?
  191. A: Email to jami.laakkonen@kolumbus.fi
  192.